home *** CD-ROM | disk | FTP | other *** search
/ PC-Blue - MS DOS Public Domain Library / PC-Blue MS-DOS Public Domain Library - NYACC.iso / vol020 / xref1.doc < prev   
Encoding:
Text File  |  1987-01-11  |  2.2 KB  |  47 lines
  1.  
  2.  
  3.         This program reads a BASIC program, saved in ASCII
  4. format by using the ",A" option of BASIC, and prepares either a
  5. neat listing, a cross-reference list, or both.  The
  6. cross-reference list shows, for each symbol and each referenced
  7. line number, the line numbers in which they occur.  This is a
  8. highly valuable aid to debugging.  It assists the user in
  9. finding inadvertent uses of the same variable name for two
  10. different purposes, or of different variable names where the
  11. same one was intended, and in locating the source of improper
  12. branches.
  13.  
  14.         The program was contributed to the BPC by Jeff
  15. Friedhoffer, and has been revised by Jim Fennessey.  It was
  16. originally published in the June 1981 issue of Interface Age
  17. magazine, and was adapted to the IBM PC by Steve Nossen.  This
  18. program may not be sold and may not be used for commercial
  19. gain.
  20.  
  21.         The program asks for filespecs of BASIC programs to be
  22. processed.  Up to 9 separate programs may be processed in a
  23. single run of XREF1.  The programs to be processed should have
  24. been previously saved using the ",A" option to produce an ASCII
  25. file, and should be resident in one of the disk drives.  The
  26. output specification defaults as the printer, but may also be
  27. the communication port or a disk drive.  It is generally most
  28. convenient to ask for the output to be sent to a disk, using
  29. the same name as the original program, and the extension
  30. ".XRF".  Then, once the XREF1 program has finished, you may use
  31. the DOS COPY command to copy filname.XRF to the printer.
  32.  
  33.         XREF1 provides an ongoing indication of its progress
  34. through the program files, and sounds a distinctive tone when
  35. it finishes.  Thus, it may be left running unattended if
  36. desired.
  37.  
  38.         One feature worth noting is that if XREF1 encounters a
  39. line in the input program which ends in the characters  'PG
  40. then it will begin a new page of the output listing with that
  41. line of the input program.  Thus, if your input program has
  42. several major sections, you can arrange it so that XREF1 starts
  43. each new major section on a new page.
  44.  
  45. This Cross reference pgm came from the Baltimore PC Users Group
  46. Diskette offering.
  47.